home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / programming / assemblers / afl-seka.lha / tjseka.doc next >
Encoding:
Text File  |  1980-01-01  |  10.1 KB  |  331 lines
  1. ;----------------------------------------------------------------------
  2. ;
  3. ;    T.J. >>> The Phantastograph <<< BERLIN presents the NEW
  4. ;
  5. ;    MASTERSEKA V1.94 / 03
  6. ;
  7. ;
  8. ;    Versionänderungserklärungen stehen ganz unten !!!
  9. ;
  10. ;    Alle Seka-Versionen die als Process laufen,hatten einen grossen
  11. ;    Fehler.Man konnte die Dos-Routine OUTPUT() nicht fehlerfrei
  12. ;    anwenden.Diesen Fehler habe ich nun endlich behoben.Moechte
  13. ;    bloss wissen wer auf die Schnapsidee kam,in der Process-
  14. ;    Struktur den Standart Ein/Ausgabe Pointer auf Null zu setzen,
  15. ;    statt sie richtig zu beschreiben.TJ
  16. ;
  17. ;    Anleitung zur verbesserten Seka-Version V1.54 und V1.6
  18. ;    Einige Requester wie z.B. Chip/Fast u.s.w habe ich nicht mit
  19. ;    eingebaut.Sie wurden von mir als stoerend empfunden.
  20. ;    Wichtig aber sind z.b. die File-Requester und der
  21. ;    Directory-Requester.Ein neuer Requester wurde von mir 
  22. ;    mit einintegriert,der Notiz-Requester.Man hat auch die
  23. ;    Moeglichkeit SEKA-Befehle in diesen Requester einzugeben
  24. ;    und mit Rechter-Alt-Taste und Help-Taste auszufuehren.
  25. ;
  26. ;    Beispiel:  cls\q$50000\q$60000\n$4\      Der \ verursacht
  27. ;                         ein RETURN + Leerzeile
  28. ;
  29. ;    Beispiel:  cls|q$50000|q$60000|n$4|     Der | verursacht
  30. ;                         ein RETURN ohne
  31. ;                         Leerzeile
  32. ;    Ohne \ oder | koennen keine Befehle
  33. ;    im Notiz-Requester ausgefuehrt werden !
  34. ;    ---------------------------------------------------------------
  35. ;
  36. ;    Die Notizen können mit RAmiga-Help-Taste abgespeichert werden.
  37. ;
  38. ;    Die Notizen können voreingestellt werden.Dazu ist in der
  39. ;    Masterseka.Startup Datei der Parameter -n anzugeben.Danach folgt
  40. ;    der Text,der unbedingt mit ! zu beenden ist.Wird das ! vergessen,
  41. ;    kann es zum Absturz führen.Die maximale Textlänge darf 160 nicht
  42. ;    überschreiten!!!
  43. ;
  44. ;    Beispiel:
  45. ;
  46. ;    -n
  47. ;    Heute ist ein schöner Tag zum hacken.
  48. ;    Amiga is the best.!
  49. ;
  50. ;
  51. ;
  52. ;    Achtung vom Gebrauch -m 006 fff 111 222!
  53. ;    Der Parameter -m erlaubt eine Voreinstellung der RGB-Palette für
  54. ;    die Palette 0,1,2,3.Im obigen Beispiel hat Pal0 die Farbe 006,
  55. ;    Pal1 = fff,Pal2 = 111,Pal3 = 222.Es sind bei 1er Bitplane natürlich
  56. ;    nur die Paletten 0 und 1 gültig.
  57. ;    Ganz besonders wichtig ist,das nach -m ein space steht,und am Schluss
  58. ;    der Eingabe direkt ein Ausrufezeichen (!).Siehe oben.
  59. ;
  60. ;
  61. ;
  62. ;    Alle Neuen Befehle sind in der Erklaerung mit NEW -> bezeichnet.
  63. ;    
  64. ;
  65. ;----------------------------------------------------------------------
  66.  
  67.  
  68.  
  69.     Bitte die req.library V1.22 benutzen.Ältere Versionen könnten nicht
  70.     funktionieren.
  71.  
  72.  
  73.  
  74. CLI and/or 'MasterSeka.startup' file options
  75. --------------------------------------------
  76.  
  77.     Syntax (with '-')         Explanation
  78.     ---------------------------------------------------------------
  79.     -a AbsoluteAdr        : Workspace at Adr
  80.     -b Scrollbarflag    : flag: 0=none, 1=right, 2= left border
  81.     -c            : Workspace in Chipmemory
  82. NEW ->    -d            : Turns off the menu-display starting
  83.                 ; the seka,but calling it with hl.
  84.     -e Editorsize        : size: number of editor lines
  85. NEW ->    -f             : If using this Parameter,your F-Keys
  86.                 ; have normal Functions (h0),else you can
  87.                 ; use them as Marker-Keys (h1)
  88.     -h Historysize        : size: history size (default: 127)
  89.     -l flag            : flag: 0=linenumbers off 1=on
  90. NEW ->  -m            : -m 0f0 a64 b00 047!
  91.                 : Parameter for RGB-Palette ended with !
  92.                 : (Pal 0,Pal 1,Pal 2,Pal 3)
  93. NEW ->    -n text!        ; Text for Notice-Requester must ending with !
  94.     -r            : Use REQ.LIBRARY Filerequester
  95.     -s Screendepth        : depth: 0=window, 1=1 plane, 2=2 planes
  96. NEW ->    -t             : Turns off the Sound after you assemble
  97.                 ; a program.Normally its on. 
  98.     -w X Y Width Heigth    : Size of window (set either parameter to
  99.                   0 to use its default, use PAL/NTSC size
  100.     -w+ X Y Width Heigth    : Dito, but use workbench screen size
  101.     -X            : Close workbench (only when start from WB)
  102.  
  103.  
  104. MasterSeka commands (optional parameters in '[' and ']')
  105. --------------------------------------------------------
  106.     !            : Quit/Restart Seka
  107. NEW ->    :            : Quit Seka quickly
  108. NEW ->  |            : AMIGA FAST RESET
  109.     =            : WorkInfo
  110.     >[<SPACE>Filename]    : Copy output to file (close file with '>'!)
  111.     ?            : evaluate expression
  112.     @[Command]        : execute CLI command
  113.     a[Address]        : assemble (for options: see below)
  114.     b            : bottom
  115.     bAddress        : calculate bootblock checksum for Address
  116.     c            : compare memory ranges
  117.     cl            : kill source
  118.     cls            : clear screen
  119.     d[Address]        : dissassemble
  120.     e[Line number]        : edit line
  121.     f            : find in memory
  122.     fi            : fill memory
  123.     g[Address]        : jump to address
  124. NEW ->    h            : System Pointer
  125. NEW ->    hh            : System Pointer without cls
  126. NEW ->    h0            : Turn to normal F-Keys (SETMAP)
  127. NEW ->    h1            : Turn to Marker F-Keys (EDITOR)
  128. NEW ->    hl            : Show Menu
  129.     i[Line number]        : insert line
  130.     j[Address]        : JSR to address
  131.     ka            : free absolute memorylist (see 'INCBIN')
  132.     kf[<SPACE>Filename]    : delete file
  133.     kl            : kill linkfile in memory
  134.     kp            : kill paste buffer
  135.     ks            : kill source
  136.     l[Searchstring]        : search source for searchstring
  137.     m[Address]        : modify memory
  138.     n[Address]        : show ASCII dump
  139.     o            : old (get source back after 'ks')
  140.     p[Amount]        : display 'Amount' sourcelines from current
  141.     q[Address]        : hexdump memory
  142.     r[<SPACE>Filename]    : read source
  143.     ri[<SPACE>Filename]    : read binary file
  144.     rl[<SPACE>Filename]    : read link file
  145.     ro[<SPACE>Filename]    : read executable (LoadSeg)
  146.     rs[Drivenumber]        : read sectors
  147.     rt[Drivenumber]        : read cylinders
  148. NEW ->    rgb            : Color Requester
  149. NEW ->    s0            : Sound after assemble off
  150. NEW ->    s1            : Sound after assemble on
  151.     s[Address]        : single step code
  152.     t[Linenumber]        : jump to top of source or specified line
  153.     u[Address]        : UnloadSeg executable
  154.     v[Pathname]        : show directory
  155.     v<SPACE>Pathname    : change directory
  156. NEW ->    vv            ; Direktory with File-Requester
  157.     w[<SPACE>Filename]    : write source
  158.     wbFlag            : Flag: 0=Close WB, 1=Open WB
  159.     wi[<SPACE>Filename]    : write binary file
  160.     wl[<SPACE>Filename]    : write link file
  161.     wo[<SPACE>Filename]    : write executable
  162.     ws[Drivenumber]        : write sectors
  163.     wt[Drivenumber]        : write cylinders
  164.     y            : load EXTERNS
  165.     zAmount            : zap 'Amount' lines
  166.  
  167.  
  168. assemble options
  169. ----------------
  170.     A    :    Error on absolute memory adr mode (for debugging)
  171.     E    :    Listing on printer
  172.     H    :    Stop after each page of the listing
  173.     L    :    Produce linkable code
  174.     O    :    Optimize
  175.     P    :    Listing on printer (same as E)
  176.     R    :    Error on reloc entry (non pc-relative code)
  177.     V    :    Listing on screen
  178.  
  179.  
  180. Shortcuts with Amiga-key (Direct mode marked with a '*')
  181. --------------------------------------------------------
  182.     a    :    Search previous occurence
  183.     A    :    Assemble quickly (no options specified)
  184.     b    :    Mark block
  185.     c    :    Copy block
  186.     g    :    Goto line
  187.     i/l    :    Insert block
  188.     k    :    Cut line
  189.     *q    :    Quit MasterSeka
  190.     q    :    Quit editor
  191.     r    :    Replace next occurence
  192.     R    :    Replace ...
  193.     s    :    Search next occurence
  194.     S    :    Search ...
  195.     t    :    Top of file
  196.     T    :    Bottom of file
  197.     u    :    Block to lowercase
  198.     U    :    Block to uppercase
  199.     w    :    Save block
  200.     x    :    Cut block
  201.     y    :    Cut to end of line
  202.  
  203.  
  204. Shortcuts with CTRL-key:
  205. ------------------------
  206.     A    :    One screen up
  207.     B    :    Mark block
  208.     C    :    Cut block
  209.     D    :    Delete to end of lines
  210.     E    :    Cursor to End of Line
  211.     F    :    Paste block (fill)
  212.     J    :    Search for text (jump)
  213.     K    :    Kill line
  214.     L    :    Lower case
  215.     O    :    Insert line
  216.     P    :    Paste
  217.     Q    :    Cursor to Start of Line
  218.     R    :    Rotate block
  219.     S    :    100 lines up
  220.     T    :    Top of File
  221.     U    :    Upper case
  222.     W    :    Write block to disk
  223.     X    :    100 lines down
  224.     Y    :    One screen down
  225.     Z    :        "
  226.     [    :    ESC
  227. NEW ->  HELP    :    Remark-Requester
  228.  
  229.  
  230. Shortcuts with CTRL-LShift-Key:
  231. -------------------------------
  232.  
  233. NEW ->    HELP    :    System Pointer
  234.  
  235.  
  236. Shortcuts with LALT-Key:
  237. ------------------------
  238.  
  239. NEW ->    HELP    :    Color Requester
  240.  
  241.  
  242. Shortcuts with RALT-Key:
  243. ------------------------
  244.  
  245. NEW ->    HELP    :    Execute Statements written in Remark Requester
  246.  
  247.  
  248. Shortcuts with RAmiga-Key:
  249. ------------------------
  250.  
  251. NEW ->    HELP    :    Save Notizen
  252.  
  253.  
  254. Pseudo opcodes (directives)
  255. ---------------------------
  256.     Syntax            : Explanation        : Example
  257. --------------------------------------------------------------------------
  258.     align Size[,Offset]    : align PC        : align 32
  259.     blk.B/W/L Size[,Code]    : fill block        : blk.b 100,'C'
  260.     code            : code section        :
  261.     cnop Size[,Offset]    : see 'align'        :
  262.     dc.B/W/L Size[,Code]    : insert constants    : dc.b "CORSAIR"
  263.     ds.B/W/L Size[,Code]    : see 'blk'        :
  264.     endif            : terminate conditional    :
  265.     endm            : terminate macro def.    :
  266. symbol:    equ            : define symbol        : sysbase equ 4
  267.     else            : conditional assembly    :
  268.     even            : align PC to even    :
  269.     end            : end of source        :
  270.     globl            : global symbol (link)    :
  271.     if Expression        : conditional assembly    :
  272.     illegal            : breakpoint $4AFC    :
  273.     incbin "Filename"    : include file in object: incbin "Data"
  274.     incbin "Filename",Adr    : load file to Adr    : incbin "A",$50000
  275.     list            : assembly listing on    :
  276.     load Address        : assemble to 'Address'    : load $50000
  277. symbol:    macro            : start macro definition: flop: macro
  278.     nlist            : assembly listing off    :
  279.     odd            : align PC to odd    :
  280.     org Address        : generate absolute code:
  281.     page            : listing -> new page    :
  282.     plen pagelen        : set page length    : page 66
  283.     pwid pagewid        : set page width    : pwid 70
  284.     pinit expression    : init page settins    :
  285.     section name,type    : code,code_c,bss,bss_c    : section aa,BSS_C
  286.  
  287. 68020 instructions supported:
  288. -----------------------------
  289.     index scale:    eg. move.w (a0,d0.w*4),d0
  290.        DIVs.L
  291.     DIVsL.L
  292.     EXTB.L
  293.     MOVEC            Rc: SFC,DFC,CACR,USP,VBR,CAAR,MSP,ISP
  294.     MOVES
  295.     MULs.L
  296.     MULs.L
  297.     RTD
  298.     TST    An/D16(PC)/D8(PC,Rn)
  299.  
  300. ============================================================================
  301.  
  302.  
  303. Änderungen von Version 1.83 bis Version  1.89 :
  304.  
  305. Chip & Fastmem-Anzeige ist nun nicht mehr verdreht (Funktion H).
  306. Absturz nach Aufruf der Dos-Routine (OUTPUT) ist behoben.Andere Seka-Versionen
  307. sind davon alle immernoch betroffen,sofern sie als Process laufen.
  308. Kalkulations-Routine ist übersichtlicher gestaltet.
  309. Die Pfade für die File-Requester sind von 16 auf 36 vergrößert.(Eingabe-Länge)
  310.  
  311. Wird bei der Funktion q$50000 ausgelöst + die linke Maustaste gedrückt (die ganze
  312. Zeit über),so befindet man sich im Real-Time Monitor,bis die Taste wieder
  313. losgelassen wird.
  314.  
  315. Bei Eingabe von q$50000 + rechte Maustaste wird der Ganze Speicher schnell
  316. durchgescrollt ! Mit Ctrl S stoppen mit Ctrl Q weiter mit Ctrl C beenden !
  317.  
  318.                             GRUSS T.J.
  319.  
  320. Versionsänderung von V1.90 nach V1.93:
  321.  
  322. Bottblock-Checksumme ist jetzt wieder in Ordnung ! (Befehl b ADR)
  323. Im Befehl h steht zusätzlich die 1. und 2.Bitplane vom angewählten Screen !
  324. Direktories werden mit *­­­­­> angezeigt. (Geschmackssache) !
  325.  
  326. Versionsänderung von V1.93 nach V1.94:
  327.  
  328. Mit dem Zeichen | und RETURN wird ein AMIGA-FAST-RESET eingeleitet !
  329.  
  330.  
  331.